home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / nukey40.arc / NEWKEY.DOC < prev    next >
Text File  |  1987-05-02  |  25KB  |  733 lines
  1.  
  2.  
  3.  
  4.           
  5.           
  6.           
  7.           
  8.           
  9.            
  10.           
  11.           
  12.           
  13.           
  14.           
  15.           
  16.           
  17.           
  18.           
  19.           
  20.                                          NEWKEY
  21.                                   DEMONSTRATION GUIDE
  22.           
  23.                                  A Keyboard Enhancer for
  24.                                 The IBM Personal Computer
  25.           
  26.                                      Version 4.0 
  27.           
  28.                               
  29.           
  30.                                   
  31.           
  32.                          (C)Copyright Frank A. Bell, 1984, 1986, 1987
  33.                                   All rights reserved.
  34.           
  35.                              
  36.           
  37.           
  38.           
  39.                             
  40.           
  41.           
  42.           
  43.           
  44.           
  45.           
  46.           FAB Software
  47.           P.O. Box 336
  48.           Wayland, MA 01778
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.           
  59.           
  60.           
  61.           
  62.  
  63.  
  64.  
  65.                                              
  66.           
  67.           
  68.           
  69.           COPYRIGHT
  70.           
  71.           Copyright (C) 1984, 1986, 1987 by Frank A. Bell.  All rights 
  72.           reserved.  
  73.           
  74.           The special full-power evaluation Newkey 4.0 programs may be 
  75.           copied subject to the restrictions listed in 'Permission to Copy'.  
  76.           
  77.           This documentation is designed to accompany the Newkey 
  78.           demonstration disk and does not fully document Newkey and its 
  79.           features.  The latest version of Newkey, a printed manual, plus 
  80.           other benefits come with Newkey when ordered.  For further 
  81.           information refer to the section on registration later in this 
  82.           documentation.  
  83.           
  84.           If any portion of the demonstration disk is missing, a complete 
  85.           demonstration disk is available for $10.  Use the order form at 
  86.           the end of this documentation.  Please do not send disks.
  87.           
  88.           
  89.           
  90.                                
  91.           TRADEMARKS 
  92.           
  93.           Prokey is a trademark of RoseSoft.  
  94.           IBM is a registered trademark of International Business Machines.  
  95.           
  96.           
  97.           
  98.           
  99.           
  100.           
  101.           
  102.           
  103.           
  104.           
  105.           
  106.           
  107.           
  108.           
  109.           
  110.           
  111.           
  112.           
  113.           
  114.           
  115.           
  116.           
  117.           
  118.           
  119.           
  120.           
  121.           
  122.           
  123.  
  124.  
  125.  
  126.                                   TABLE OF CONTENTS
  127.           
  128.           
  129.           NEWKEY INTRODUCTION.......................................... 1    
  130.           
  131.           TAKING A GUIDED TOUR OF NEWKEY............................... 3    
  132.           
  133.           THE USER-SUPPORTED CONCEPT................................... 4    
  134.            
  135.           RESTRICTED PERMISSION TO COPY................................ 5    
  136.            
  137.           FILES ON THE NEWKEY DISK..................................... 6    
  138.            
  139.           LIMITED WARRANTY............................................. 8    
  140.            
  141.           REGISTRATION................................................. 8    
  142.            
  143.           ORDER FORM................................................... 9    
  144.           
  145.           
  146.           
  147.           
  148.           
  149.           
  150.           
  151.           
  152.           
  153.           
  154.           
  155.           
  156.           
  157.           
  158.           
  159.           
  160.           
  161.           
  162.           
  163.           
  164.           
  165.           
  166.           
  167.           
  168.           
  169.           
  170.           
  171.           
  172.           
  173.           
  174.           
  175.           
  176.           
  177.           
  178.           
  179.           
  180.           
  181.           
  182.           
  183.           
  184.  
  185.  
  186.  
  187.                                                                      Page 1
  188.           
  189.                                     NEWKEY INTRODUCTION
  190.           
  191.           We believe that at $30.00, $50 - $100 below comparable commercial 
  192.           programs, Newkey is one of the great bargains on the market today.  
  193.           How many high quality, useful software programs that come with a 
  194.           printed manual can be purchased for $30?  We hope that after you 
  195.           have had a chance to try out Newkey for yourself you agree and 
  196.           decide to become a reqistered user.  
  197.           
  198.           PURPOSE 
  199.                
  200.           The Newkey keyboard enhancer simplifies the entry of common 
  201.           keystroke sequences by allowing these sequences to be assigned to 
  202.           any key desired.  Once assigned to a particular key, whenever that 
  203.           key is struck the predefined sequence of keystrokes will be returned 
  204.           in place of the struck key.  For example, the alt c key might be 
  205.           defined as 'copy' and whenever alt c is struck the string 'copy' 
  206.           will be returned.  
  207.           
  208.           Newkey allows customization of software packages, ready creation of 
  209.           boiler plate passages, keyboard redefinition and other useful 
  210.           purposes.  Several sample key definition files are included with 
  211.           Newkey and will be described later.  
  212.           
  213.           Newkey 4.0 provides many features including: 
  214.           
  215.           -  Ability to define almost any key 
  216.           -  Variable length pauses during key translation 
  217.           -  Fixed length pauses during key translation 
  218.           -  Nested key translation 
  219.           -  Translation bypass for native entry of defined key 
  220.           -  Dynamic display of the macro directory 
  221.           -  Dynamic display of macros 
  222.           - Full featured macro editor 
  223.             - Easily change any macro 
  224.             - Copy/Move one macro to another 
  225.             - Move keyboard buffer into macro 
  226.           - Load, merge and save macro files from within other applications 
  227.           - Shorthand mode, Newkey watches your keystrokes and when they 
  228.           match a macro name, automatically plays back the macro.  No 
  229.           special hot key to enter, no wasted keystrokes.
  230.            - Date/time macro 
  231.           function, define your own date & time templates and let Newkey 
  232.           fill them in for you
  233.           - Fast key option allows fast cursor movement 
  234.           and key repetition 
  235.           - Use Newkey's pop-up features in graphics mode 
  236.           - Compatible with new IBM's new 'enhanced keyboard'
  237.           - Guard macros 
  238.           from accidental deletion 
  239.           - Inactivate macros 
  240.           - Save/load file overwrite warning messages 
  241.           - Disk wait during macro playback 
  242.           - Screen on/off macro function 
  243.           - Enhanced compatibility with other programs 
  244.             - Suppress Newkey created keycodes which collide with other programs
  245.  
  246.  
  247.  
  248.                                                                      Page 2
  249.           
  250.             - Compatible with Popular Program's 'pop-ups' programs 
  251.           - Keyboard click
  252.           - Beep during macro definition 
  253.           - Cursor change during macro definition/playback made optional 
  254.           - Customize Newkey's menu colors 
  255.           - Screen blanker works with EGA
  256.           -  Dynamic modification of the control keys 
  257.           -  Dynamic clear macros from memory
  258.           -  User defined dynamic define area length 
  259.           -  Time delay pauses during key translation 
  260.           -  Toggle Newkey on/off
  261.           -  Slow typing mode
  262.           -  Cancel Newkey processing at any time during playback or definition
  263.           -  Macro may call itself
  264.           -  Screen saver feature to blank screen after period of inactivity
  265.           -  Ability to define a macro within a macro
  266.           -  Multi-character macro names
  267.           -  Improved screen saver that works with most hardware and software
  268.           -  Macro descriptions
  269.           -  128 keystroke typeahead buffer
  270.           -  Speed up keyboard repetition rate
  271.           -  Improved macro definition facilities, including
  272.           
  273.              -  Defining status line
  274.              -  Macro already defined warning message
  275.              -  Defining alphabetic character warning message
  276.              -  Display/execute macro commands from menus as well as
  277.                 from control keys
  278.              -  Macro definition window
  279.           
  280.           -  Call Newkey from its own macros
  281.           -  Cut & paste
  282.           -  Support for DOS 2.0 path names
  283.           -  and many more
  284.           
  285.           Newkeysp 4.0, the Newkey support program, provides many functions 
  286.           including: 
  287.           
  288.           -  Saving macros to disk from memory
  289.           -  Loading macros from disk to memory
  290.           -  Merging macros from disk to memory
  291.           -  Directory display of keys with translations
  292.           -  Individual display of key translations
  293.           -  Easy modification of Newkey control keys
  294.           -  Clear macros from memory
  295.           -  Toggle Newkey on/off
  296.           -  Execute macros from a batch file
  297.           -  Unload and reclaim memory under DOS 2.0
  298.           -  Be called from Newkey macros
  299.           -  Display macros and their descriptions
  300.           
  301.           
  302.           
  303.           
  304.           
  305.           
  306.  
  307.  
  308.  
  309.                                                                      Page 3
  310.           
  311.                            TAKING A GUIDED TOUR OF NEWKEY
  312.                         
  313.           The guided tour demonstrates many of Newkey 4.0's major features 
  314.           and uses Newkey macros extensively.  To get started follow these 
  315.           steps: 
  316.           
  317.           1.  Create a Newkey disk which has DOS on it (not absolutely 
  318.           necessary, but it may save disk swapping during the demo.)
  319.           
  320.           2.  Place the Newkey disk in the default drive.
  321.           
  322.           3.  Key 'demo' and hit enter.  This will take you on a guided 
  323.           tour of Newkey.  The tour requires 192K of memory.  
  324.           
  325.           NOTE TO USERS OF IBM'S ENHANCED KEYBOARD
  326.           
  327.           Because Newkey works a little differently with the new "enhanced 
  328.           keyboard" it is necessary to reconfigure some of Newkey's hot 
  329.           keys.  The batch file "enhanced" will do this for you and tell you 
  330.           which hot keys have been updated.  This is necessary because the 
  331.           default hot keys will not work on the enhanced keyboard.  
  332.           
  333.           The guided tour uses many of these hot keys and refers to them by 
  334.           their default values.  You will have to recognize that the hot key 
  335.           defaults have changed.  These changes are:
  336.           
  337.           old         new        Description
  338.           ----        ---        -----------
  339.           ctrl/       alt/       Pop-up features 
  340.           ctrl3       alt[       Slow typing on request 
  341.           ctrl4       alt]       Slow typing off request 
  342.           ctrlesc     ctrl\      Cancel macro playback 
  343.           cutpaste    altp       Cut & paste playback
  344.           
  345.           
  346.           NOTE TO USERS WITH AMBER OR SIMILAR MONITORS:
  347.           
  348.           The colors Newkey uses may cause the display of certain monitors 
  349.           to wash out, with the result that much, if not all, of the Newkey 
  350.           text will be unreadable.  This may be fixed by turning on 
  351.           Newkey's black & white option.  
  352.           
  353.           To turn on the black & white option, load Newkey and then type in 
  354.           the following command: 
  355.           
  356.                   newkeysp/b
  357.           
  358.           and press enter.  A message will be displayed indicating that the 
  359.           black and white mode has been turned on.
  360.           
  361.           NOTE TO USERS OF EBL:
  362.           
  363.           EBL (version 2.03) will not function correctly if Newkey is 
  364.           loaded last, therefore be sure to load Newkey before EBL.
  365.           
  366.           
  367.  
  368.  
  369.  
  370.                                                                      Page 4
  371.           
  372.                              THE USER-SUPPORTED CONCEPT
  373.           
  374.                                User-supported Software 
  375.           
  376.           User-supported software is an experiment in distributing 
  377.           computer programs based on these beliefs: 
  378.           
  379.           1.  That the value and utility of software is best assessed by 
  380.               the user on his/her own system.  
  381.           
  382.           2.  That the creation of personal computer software can and 
  383.               should be supported by the computing community.  
  384.           
  385.           3.  That copying of programs should be encouraged, rather than 
  386.               restricted.  
  387.           
  388.           Anyone may legally obtain an evaluation copy of the program from 
  389.           a friend or computer club.  After you have had a chance to use 
  390.           and evaluate the program in your own environment, you are 
  391.           trusted to either forward a payment to FAB Software or to 
  392.           discontinue use of the program.  
  393.           
  394.           Free distribution of software and voluntary payment for its use 
  395.           eliminates costs for advertising and copy protection schemes.  
  396.           Users obtain quality software at greatly reduced cost.  They can 
  397.           try it out before buying, and do so at their own pace and in the 
  398.           comfort of their own home or office.  The best programs will 
  399.           survive, based purely on their quality and usefulness.  
  400.           
  401.           
  402.           
  403.           
  404.           
  405.           
  406.           
  407.           
  408.           
  409.           
  410.           
  411.           
  412.           
  413.           
  414.           
  415.           
  416.           
  417.           
  418.           
  419.           
  420.           
  421.           
  422.           
  423.           
  424.           
  425.           
  426.           
  427.           
  428.  
  429.  
  430.  
  431.                                                                      Page 5
  432.           
  433.                        RESTRICTED PERMISSION TO COPY
  434.           
  435.           With the release of version 4.0 we are providing a special 
  436.           full-power evaluation copy of Newkey which may be copied subject 
  437.           to the restrictions listed below.  The only difference between the 
  438.           evaluation version and the version available to registered users 
  439.           is a special "evaluation notice" screen that is displayed when 
  440.           Newkey or Newkeysp is first started up.  
  441.           
  442.           What May be Copied
  443.           
  444.           All files on the Newkey disk may be copied except for the regular 
  445.           versions of "NEWKEY.EXE", "NEWKEYSP.EXE", and "NEWKEYSM.EXE" which 
  446.           are reserved for registered users.  These versions may only be 
  447.           used by our registered users and may not be copied or shared.  If 
  448.           you are evaluating Newkey then these versions should not be on 
  449.           your disk.
  450.           
  451.           If an "evaluation notice" screen is displayed and you have to 
  452.           press a key to continue when you first use these programs, then 
  453.           you are using the shareware versions.  
  454.           
  455.           Rules For Copying Evaluation Version
  456.           
  457.           Individuals are granted permission to freely copy the Newkey disk 
  458.           for their own evaluation or for others to evaluate, so long as no 
  459.           price or other consideration is charged.  
  460.           
  461.           Computer clubs and other non-profit organizations are granted 
  462.           permission to freely copy the Newkey disk and share it with their 
  463.           members for the purposes of evaluation, so long as: 
  464.           
  465.           1.  No price or other consideration is charged.  However, a 
  466.           distribution cost may be charged for the  cost of the diskette, so 
  467.           long as it is not more than US $10 total.  This includes shipping, 
  468.           handling, and all other charges.  
  469.           
  470.           2.  Club members who receive the programs are informed in writing 
  471.           of the user-supported concept and encouraged to support it with 
  472.           their payments.  
  473.           
  474.           3.  The programs and documentation are not modified in any way and 
  475.           are distributed together.  
  476.           
  477.           4.  The Newkey disk may not be packaged together with any other 
  478.           programs or materials.  It may not be bundled and sold as part of 
  479.           some other more inclusive package.  
  480.           
  481.           5.  The programs may not be "rented" to others.  
  482.           
  483.           6.  The printed manual is not copied or reproduced in any way.  
  484.           
  485.           Companies, schools, universities, government, and other 
  486.           organizations are granted permission to copy the Newkey programs 
  487.           for use on other computers and at other locations in the company, 
  488.           so long as: 
  489.  
  490.  
  491.  
  492.                                                                      Page 6
  493.           
  494.           
  495.           1.  The full registration fee of $30 has been paid for each and 
  496.           every system on which the program will be used.  
  497.           
  498.           2.  The printed manual is not copied or reproduced in any way.  
  499.           
  500.           Corporate licenses and volume discounts are available upon 
  501.           request.
  502.           
  503.                              FILES ON THE NEWKEY DISK
  504.           
  505.           The following files should be on the Newkey demonstration disk.  
  506.           If any are missing on the copy you have, a complete evaluation 
  507.           copy may be obtained from FAB Software for $10.  Use the order 
  508.           form at the end of this documentation.  Please do not send disks.  
  509.           
  510.           BOX.KEY - Box drawing macros.
  511.           
  512.           DEMO.BAT - This is a batch file which will give you a 
  513.           demonstration of Newkey.  It requires 192k of memory.  
  514.           
  515.           DEMO.KEY - Key definition file containing Newkey tour.
  516.           
  517.           DVORAK.KEY - Key definition file to redefine keyboard under Dvorak 
  518.           layout.
  519.           
  520.           ENHANCED.BAT - Customize Newkey's control keys to work with 
  521.           enhanced keyboard.
  522.           
  523.           ENHANCED.KEY - Macro file used by ENHANCED.BAT
  524.           
  525.           EXAMPLE.BAT - Examples of NEWKEYSP usage.
  526.           
  527.           LOADNEW.BAT - This is a sample batch file which will 
  528.           load Newkey and the sample Wordstar key definition 
  529.           file, WS.KEY.  
  530.           
  531.           NEWKEY.DOC - Documentation which will introduce 
  532.           unregistered users to Newkey.  To print it key in 'printdoc'
  533.           and press enter.
  534.           
  535.           NEWKEY.EXE - This is the program which actually replaces IBM's 
  536.           keyboard interrupts (x'9' and x'16').  This program remains 
  537.           resident while other programs execute and unless called upon to 
  538.           translate will be transparent.  
  539.           
  540.           NEWKEYSM.EXE - This is the small version of Newkey.exe.  It lacks 
  541.           the pop-up features and takes less memory.
  542.           
  543.           NEWKEYSP.EXE - This program provides several functions 
  544.           necessary to effectively use Newkey.
  545.           
  546.           ORDER.FRM - Order form.
  547.           
  548.           PRINTDOC.BAT - This prints Newkey documentation from disk.
  549.           
  550.  
  551.  
  552.  
  553.                                                                      Page 7
  554.           
  555.           PRINTEST.BAT - This prints test macro file documentation from disk.  
  556.           
  557.           PRINTWS.BAT - This prints Wordstar key definition file 
  558.           documentation from disk.
  559.           
  560.           TEST.KEY - Test macro file.
  561.           
  562.           TESTKEY.DOC - Documentation for test macros.
  563.           
  564.           WS.KEY - Wordstar key definition file.
  565.           
  566.           WSKEY.DOC - Documentation for Wordstar macros.
  567.           
  568.           123.KEY - Lotus 1-2-3 macros.
  569.           
  570.           123.DOC - Documentation for 123 macros.
  571.           
  572.           
  573.           
  574.           
  575.           
  576.           
  577.           
  578.           
  579.           
  580.           
  581.           
  582.           
  583.           
  584.           
  585.           
  586.           
  587.           
  588.           
  589.           
  590.           
  591.           
  592.           
  593.           
  594.           
  595.           
  596.           
  597.           
  598.           
  599.           
  600.           
  601.           
  602.           
  603.           
  604.           
  605.           
  606.           
  607.           
  608.           
  609.           
  610.           
  611.  
  612.  
  613.  
  614.                                                                      Page 8
  615.           
  616.                                    LIMITED WARRANTY
  617.           
  618.           
  619.           These programs are provided "as is" without warranty of any kind, 
  620.           either expressed or implied, including, but not limited to the 
  621.           implied warranties of merchantability and fitness for a particular 
  622.           purpose.  The entire risk as to the quality and performance fo the 
  623.           program is with you.  Should the program prove defective, you (and 
  624.           not FAB Software or its dealers) assume the entire cost of all 
  625.           necessary servicing, repair or correction.  
  626.           
  627.           In no event will the FAB Software be liable to you for any damages, 
  628.           including any lost profits, lost savings or other incidental or 
  629.           consequential damages arising out of the use of or inability to use 
  630.           these programs, even if the FAB Software has been advised of the 
  631.           possibility of such damages, or for any claim by any other party.  
  632.            
  633.           
  634.           
  635.                                      REGISTRATION
  636.           
  637.           
  638.           To register as an official Newkey user complete the order form on 
  639.           the next page and send to FAB Software.
  640.           
  641.           As a registered user you will receive 
  642.           
  643.              - The latest version of Newkey 
  644.              - A version which does not display the evaluation notice screen.
  645.              - A printed manual (92 pages, tips on use, index)
  646.              - Telephone and written support
  647.              - Notification of new versions
  648.                                    
  649.           If not completely satisfied, return Newkey within 30 days for a
  650.           full refund.
  651.           
  652.           
  653.           
  654.           
  655.           
  656.           
  657.           
  658.           
  659.           
  660.           
  661.           
  662.           
  663.           
  664.           
  665.           
  666.           
  667.           
  668.           
  669.           
  670.           
  671.           
  672.  
  673.  
  674.  
  675.                                                                      Page 9
  676.           
  677.                                        ORDER FORM 
  678.           
  679.           FAB Software
  680.           P.O. Box 336
  681.           Wayland, MA 01778
  682.           ---------------------------------------------------------------
  683.                                                    PRICE       PRICE
  684.           PRODUCT                         QTY      EACH       EXTENDED
  685.           -----------------------------   ---      -----      -------- 
  686.           Newkey 4.0 (includes
  687.           printed users manual)           ___      $30.00     $_______
  688.           
  689.           
  690.           Newkey 4.0 Evaluation disk      ___      $10.00     $_______
  691.           
  692.           
  693.           Purchase Order (not prepaid)              $5.00     $
  694.                                                                -------
  695.           
  696.           Foreign Order Shipping & Handling(*)      $5.00     $
  697.           (does not include Canada)                            -------
  698.           
  699.           
  700.                                                   SUBTOTAL    $_______
  701.           
  702.           
  703.           Massachusetts state tax (5%)                        $
  704.                                                                -------
  705.           
  706.           
  707.                                                    TOTAL      $
  708.                                                                -------
  709.           
  710.           
  711.           Name: _________________________________Phone:________________
  712.           
  713.           Address:_____________________________________________________
  714.           
  715.           Address: ____________________________________________________ 
  716.           
  717.           City, State, Zip: ___________________________________________ 
  718.           
  719.           I understand that if I am not completely satisfied, I may return
  720.           Newkey within 30 days for a refund of the purchase price.
  721.           
  722.           * Foreign orders must be paid in US $ with a check drawn on a US 
  723.           bank or through the US branch of a foreign bank, or through an 
  724.           international money order.
  725.           
  726.           
  727.           
  728.           
  729.           
  730.           
  731.           
  732.           
  733.